Programming With QuickTime VR
| Previous | Chapter Contents | Chapter Top | Next |
The QuickTime VR Manager provides routines for initializing and terminating its operation.
The InitializeQTVR and TerminateQTVR routines are required for QuickTime VR to run in a Windows environment. They do nothing in the Mac OS environment, but should be included for cross-platform compatibility.
When your application calls InitializeQTVR in the Windows environment, the code attempts to find QuickTimeVR.qtx through the normal search paths. If it does not find QuickTimeVR.qtx , it returns an error code of 6660 and the API will be unusable.
You must use the InitializeQTVR function before calling other functions of QuickTime VR. The InitializeQTVR function tries to load the QuickTimeVR.qtx file, first from the application directory and then from the system directory. If the InitializeQTVR function is unable to load the QuickTimeVR.qtx file, it returns error code qtvrLibraryLoadErr (-30554).
If you call any other function of QuickTime VR before calling the InitializeQTVR function or after the InitializeQTVR function has failed to load the QuickTimeVR.qtx file, QuickTime VR returns error code qtvrUninitialized (-30555).
You must use the TerminateQTVR function when you have finished using the functions of QuickTime VR.
Multiple calls to InitializeQTVR and TerminateQTVR can be either nested or sequential, but there must be at least one call to TerminateQTVR corresponding to each call to InitializeQTVR.
| Previous | Chapter Contents | Chapter Top | Next |